|
Reality Interface Classes | ||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||
java.lang.Object | +--com.northgateis.reality.rsc.RSC
Constructs a class that accesses a subroutine on the server.
This class is often extended to provided a subroutine specific class although this is not essential.
The class can also be used independently. The following example shows how to call a subroutine called "subname" which takes two parameters. Both parameters are used for input, and one parameter returns a result.
RSCConnection con = new RSCConnection("host","dbase","user","account");
con.connect();
RSC sub = new RSC("subname", con);
sub.getParam(1).setValue("p1");
sub.getParam(2).setValue("p2");
sub.execute();
byte result[] = sub.getParam(1).getValue();
con.disconnect();
| Constructor Summary | |
RSC(RSCConnection c,
java.lang.String name)
Create a class to refer to a specific subroutine. |
|
RSC(java.lang.String name,
RSCConnection c)
Deprecated. replaced by RSC(RSCConnection, String) which is more efficient as it doesn't always prepare a subroutine first. |
|
| Method Summary | |
void |
execute()
Send all parameters, execute the subroutine, receive all result parameters and load them into the parameter structure |
void |
execute(byte[][] params)
Execute subroutine with parameters passed as byte array. |
void |
execute(java.lang.String[] params)
Execute subroutine with parameters passed as String array. |
void |
getDescription()
Get the parameter descriptions string for this subroutine from the RSC server. |
RSCDescriptor |
getDescriptor()
Returns the the parameter descriptor. |
RSCParam |
getParam(int index)
Get a pointer to a parameter descriptor by index. |
RSCParam |
getParam(java.lang.String name)
Get a pointer to a parameter descriptor by name. |
void |
update(java.util.Observable s,
java.lang.Object arg)
|
| Methods inherited from class java.lang.Object |
equals,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
| Constructor Detail |
public RSC(java.lang.String name,
RSCConnection c)
throws RSCException
name - the subroutine namec - an RSCConnection
public RSC(RSCConnection c,
java.lang.String name)
c - an RSCConnectionname - the subroutine name| Method Detail |
public void getDescription()
throws RSCException
public RSCParam getParam(java.lang.String name)
throws RSCException
name - name of parameter to get
public RSCParam getParam(int index)
throws RSCException
index - index of parameter to getpublic RSCDescriptor getDescriptor()
public void execute()
throws RSCException
public void execute(byte[][] params)
throws RSCException
params - two dimensional byte array containing all
input and output parameters. Parameters
are passed to the subroutine in the order
params[0], params[1], ...
public void execute(java.lang.String[] params)
throws RSCException
params - String array containing all
input and output parameters. Parameters
are passed to the subroutine in the order
params[0], params[1], ...
public void update(java.util.Observable s,
java.lang.Object arg)
|
Reality Interface Classes | ||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||